Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: QuickDraw GX Graphics /
Chapter 3 - Geometric Styles / Geometric Styles Reference
Functions / Getting and Setting Curve Error


GXSetStyleCurveError

You can use the GXSetStyleCurveError function to change the curve error of a style object.

void GXSetStyleCurveError(gxStyle target, Fixed error);
target
A reference to the style object whose curve error you want to change.
error
The new curve error.
DESCRIPTION
This routine sets the curve error of the style object specified by the target parameter to be the fixed-point value specified by the error parameter. You may specify any nonnegative value for this parameter.

When a path shape has a curve error of 0.0, QuickDraw GX does not approximate the path shape with a polygon shape when converting it to a polygon. Instead, QuickDraw GX simply removes off-curve control points, as shown in "Using Curve Error When Converting Paths to Polygons" on page 3-45.

A very small curve error may cause the GXSetShapeType function and certain geometric operations such as the GXInsetShape function to use inappropriate amounts of memory and time.

When you set a style's curve error using this function, you are effectively changing the curve error for all shapes that share the style.

ERRORS, WARNINGS, AND NOTICES
Errors 
out_of_memory 
style_is_nil 
parameter_out_of_range(debugging version)
Notices (debugging version) 
curve_error_already_set 
SEE ALSO
For a discussion of curve error, see "Curve Error" on page 3-14.

For examples of curve error, see "Using Curve Error When Converting Paths to Polygons" on page 3-45 and "Using Curve Error When Reducing Shapes" on page 3-49.

To determine the curve error of a style object, use the GXGetStyleCurveError function, which is described on page 3-115.

To examine the curve error of a style object associated with a particular shape, use the GXGetShapeCurveError function, which is described in the next section. To change the curve error of a style object associated with a particular shape, use the GXSetShapeCurveError function, which is described on page 3-118.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996




Navigation graphic, see text links

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help